package com.example.chamberlainserver.mapper;

import com.example.chamberlainserver.Entry.MaterialCategory;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 物资分类Mapper接口
 */
@Mapper
public interface MaterialCategoryMapper {
    
    /**
     * 添加物资分类
     * @param category 物资分类信息
     * @return 影响行数
     */
    int insertCategory(MaterialCategory category);
    
    /**
     * 根据ID更新物资分类
     * @param category 物资分类信息
     * @return 影响行数
     */
    int updateCategory(MaterialCategory category);
    
    /**
     * 根据ID删除物资分类
     * @param id 分类ID
     * @return 影响行数
     */
    int deleteCategory(@Param("id") Integer id);
    
    /**
     * 根据ID查询物资分类
     * @param id 分类ID
     * @return 物资分类信息
     */
    MaterialCategory getCategoryById(@Param("id") Integer id);
    
    /**
     * 根据名称查询物资分类
     * @param name 分类名称
     * @return 物资分类信息
     */
    MaterialCategory getCategoryByName(@Param("name") String name);
    
    /**
     * 查询所有物资分类
     * @return 物资分类列表
     */
    List<MaterialCategory> getAllCategories();
    
    /**
     * 根据父ID查询子分类
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<MaterialCategory> getSubCategories(@Param("parentId") Integer parentId);
    
    /**
     * 查询顶级分类（parentId为null的分类）
     * @return 顶级分类列表
     */
    List<MaterialCategory> getTopCategories();
}